home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / graphics / vgacad22.zip / VGACAP.DOC < prev    next >
Text File  |  1990-12-10  |  15KB  |  334 lines
  1.          VGACAP v6.1 (c) Copr. 1987-90 Lawrence Gozum & Marvin Gozum
  2.          ───────────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.     DISCLAIMER
  7.  
  8.     This product is distributed AS IS.  The authors specifically disclaim
  9.     all warranties ,expressed or implied, including ,but not limited to,
  10.     implied warranties of merchantability and fitness for a particular
  11.     purpose with respect to defects in the diskette and documentation, and
  12.     program license granted herein, in particular, and without limiting
  13.     operation of the program license with respect to any particular
  14.     application use or purpose.  In no event shall the authors be liable
  15.     for any loss of profit or any other commercial damage including but
  16.     not limited to special, incidental, consequential or other damages.
  17.  
  18.  
  19.     LICENSING AGREEMENT
  20.  
  21.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find
  22.     this program useful, you MUST register it; you will then be provided
  23.     with the latest releases of the VGACAD system see last section of this
  24.     manual).
  25.  
  26.     You can freely distribute copies of unmodified VGACAP and charge $10
  27.     max for distribution, in lieu of recognized Users Group guidelines
  28.     (e.g., Asso. of Shareware Professionals or NY Amateur Computer Club).
  29.  
  30.  
  31.     WHAT IS VGACAP ?
  32.  
  33.     VGACAP is a resident utility that captures pictures in 320x200x256
  34.     VGA/MCGA mode, any 640x480x256 SVGA mode or any 800x600x256 SVGA mode
  35.     (e.g., AST, Dell, Genoa, Orchid, Paradise, Sigma, Tseng, Video7,
  36.     Everex, C&T, Oak) supported.  VGACAP will capture and "Bsave"
  37.     320x200x256 pictures; SVGA 640x480x256 and 800x600x256 pictures will
  38.     be saved to *.RAW file files (ie., "RAW" pixel dumps).
  39.  
  40.  
  41.     WHAT IS VGAFIL ?
  42.  
  43.     VGAFIL is a conversion program for use in a batch file (*.BAT) or as an
  44.     interactive stand-alone program; RAW and BLD/PLT files are 640x480x256
  45.     or 800x600x256 screens, or 320x200x256 screens respectively.  VGAFIL is
  46.     designed to integrate directly with VGACAD v2.0 (and up) and replace
  47.     BLD2GIF and RAW2GIF.  Moreover, VGAFIL converts and saves captured
  48.     images to 256-color BMP (Windows 3.0), PCX, GIF files or 16-color GIF
  49.     files.  VGAFIL is also a utility to customize and configure VGACAP to
  50.     take advantage of specific SVGA chipset hardcoding for FAST screen
  51.     captures.
  52.  
  53.  
  54.     REQUIREMENTS
  55.  
  56.     About 512KB of memory is required for VGAFIL, although it uses about 2/3
  57.     of that; it, also, requires that the BRUN41.exe runtime module be present
  58.     in your present path; this is explained later in this manual.  You MUST
  59.     have a VGA or MCGA adaptor (at least BIOS compatible) present and an
  60.     analog monitor to use VGACAP.  VGACAP uses about 3KB of RAM.  To use
  61.     the 640x480x256 or 800x600x256 capture mode, you MUST have SVGA.
  62.  
  63.  
  64.     CONFIGURING VGACAP
  65.  
  66.     VGACAP, on default, is set for BIOS operations;  BIOS calls are 'generic'
  67.     and should work with most, if not all, SVGA cards.   However, BIOS calls
  68.     are slow.  By using the hardware configuration, VGACAP will capture
  69.     screens in 1-2 seconds compared to about 20-30 seconds for 800x600x256
  70.     screens (based on 28ms HD on 18 MHz 386sx).
  71.   
  72.     To configure VGACAP for your specific hardware type
  73.  
  74.                         VGAFIL -V <ret>
  75.  
  76.     A menu will guide you.  Simply select the letter which corresponds to
  77.     your video card chipset.  Remember, when in doubt, return the setting
  78.     to BIOS operations.
  79.  
  80.  
  81.     HOW TO USE VGACAP
  82.  
  83.     Run VGACAP before entering your painting/CAD or digitized picture
  84.     viewer.   Press <ALT-F4>, while viewing your picture in any paint/CAD
  85.     program and the screen and palette will be saved in your default drive
  86.     and directory.  If you are viewing your picture in MCGA/VGA 320x200x256
  87.     then it will be "Bsaved".  If you are NOT is MCGA/VGA 320x200x256 mode,
  88.     then VGACAP will assume you are in an SVGA mode !
  89.  
  90.                         <alt-F4> is the HOTKEY
  91.  
  92.     The first time you run the program it will save your screen and palette
  93.     to SCREEN00.BLD (.RAW) and SCREEN00.PLT respectively.  If there is an
  94.     existing SCREENxx.BLD (.RAW) or SCREENxx.PLT file, it will increment to
  95.     the next higher number.  You can use your favorite memory managers to
  96.     remove this TSR or reboot to release it from memory.
  97.  
  98.     If you are viewing in 640x480x256 SVGA mode or 800x600x256 SVGA mode,
  99.     then the SCREENxx.BLD file is changed to SCREENxx.RAW; the "Bload" header
  100.     is not included and a "RAW" contiguous pixel dump is implemented.  If you
  101.     wish, you can easily design your own utilities to read and process these
  102.     "RAW" pixel dumps; they are simple contiguous pixel dumps with file sizes
  103.     of 307,200 bytes (i.e., 640 x 480 = 307,200 pixels) for 640x480x256 SVGA
  104.     mode and 480,000 bytes for 800x600x256 SVGA mode.  The *.PLT files remain
  105.     the same.
  106.  
  107.     Note:     When in DOS or using a picture viewer (e.g., PICEM, VPIC, or
  108.               CSHOW) or application which requires a keypress to continue, it
  109.               is necessary to hit another key after hitting the 'HOTKEY'.
  110.  
  111.  
  112.     LOADING/CONVERTING SCREEN GRABS WITH VGAFIL
  113.  
  114.     If you type "VGAFIL <ret>", then you can select any filename by moving a
  115.     highlighted bar (with the arrow keys) and pressing the <return> key.
  116.     Pressing <Spc> allows you to select a different PATH, while <Esc> exits.
  117.  
  118.     A matching *.PLT file MUST exist or an error message will result.
  119.     A *.GIF or *.PCX file is created with the corresponding name.
  120.     GIF/PCX FILES WITH THE SAME NAME WILL BE OVERWRITTEN !
  121.  
  122.     On default, VGAFIL selects RAW/PLT files.  BLD/PLT files can be selected
  123.     by using the "-B" option.
  124.  
  125.                         VGAFIL -B <ret>
  126.  
  127.     On default, all captured screens are converted to GIF (87a) files.
  128.     To convert screens to 256-color PCX files, use the "-P" option.
  129.  
  130.                         VGAFIL -P <ret>
  131.  
  132.     To convert screens to 256-color BMP files for Windows 3.0, use the
  133.     "-W" option (uncompressed Windows 3.0 "Wallpaper").
  134.  
  135.                         VGAFIL -W <ret>
  136.  
  137.  
  138.     COMMAND LINE AND BATCH FILES
  139.  
  140.     VGAFIL can be used in batch (*.BAT) files for multiple conversions.
  141.     Simply type "VGAFIL [filename] " with no extension (path optional) for
  142.     every file you want to convert in your batch file;  you can also use
  143.     this method if you want to convert a specific file from DOS.
  144.  
  145.          Examples:   VGAFIL screen00
  146.                      VGAFIL -B screen00
  147.                      VGAFIL \capture\vga\screen99
  148.                      VGAFIL -B \capture\vga\screen99
  149.                      VGAFIL -P \capture\vga\screen99
  150.                      VGAFIL -W \capture\vga\screen99
  151.  
  152.     VGAFIL will automatically search for the RAW/PLT files or BLD/PLT files.
  153.     If no files are found or matching *.PLT file is missing, then an error
  154.     will result; the matching PLT files MUST be in the same drive/directory
  155.     or default drive/directory.
  156.  
  157.  
  158.     TEMP, MVGASCRN, NYBLSCRN, AND USERSCRN FILES
  159.  
  160.     TEMPorary files are used by VGACAD, SQZGIF, GIFPUB, EGA2VGA, ... (and
  161.     other utilities we may release).  When TEMP files are detected by
  162.     VGAFIL, you will be prompted to convert it.  It you acknowledge the
  163.     prompt, you will be presented with two options: 16-color encoding and
  164.     forcing 1:1 Aspect Ratio (these options will work ONLY for GIF files). 
  165.  
  166.     MVGASCRN files are essentially similar to *.RAW files.  USERSCRN files
  167.     are created with VGACAD (v2.0 and up) and SQZGIF (v2.1 and up); these
  168.     files have unusual screen sizes and have additional support files like
  169.     TEMP files.
  170.  
  171.     NYBLSCRN (a "nybble" is half a byte or 4 bits or 16 colors) files have
  172.     special meaning for VGAFIL.  If VGAFIL detects this filename, it
  173.     immediately converts the file in TRUE 16-color format; this applies
  174.     only to GIF files.
  175.  
  176.  
  177.     16-COLOR MODE GRAB & CONVERSION
  178.  
  179.     Most 640x480x16 and 800x600x16 screens can be captured IF the BIOS
  180.     configuration is used.  Through the BIOS, your video card will
  181.     determine and execute the appropriate routine, albeit much slower. 
  182.     16-color images will be saved as 256-color files with the remaining
  183.     240 colors unused UNLESS you rename the captured files to NYBLSCRN.*
  184.     and use GIF encoding (default).
  185.  
  186.     1.  Configure VGACAP (with VGAFIL to use BIOS).
  187.     2.  Load VGACAP (by "running" it).
  188.     3.  View your 16-color image in VGA 640x480x16 or SVGA 800x600x16 mode.
  189.     4.  Grab it (press alt-F4).
  190.     5.  Rename captured files to NYBLSCRN.
  191.  
  192.         eg., nename SCREEN00.* NYBLSCRN.* <ret>
  193.  
  194.     6.  Run VGAFIL and convert to GIF (ie., with NO OPTIONS ).
  195.  
  196.     Note: Using the "-P" or "-W" option will encode a 16-color .PCX or
  197.           .BMP file BUT it will be encoded and viewable as a 256-color
  198.           image with 240 colors unused (ie., you can still view the
  199.           16-color PCX or BMP file, BUT only in 256-color mode). 
  200.          
  201.           256-color PCX compression of 16-color images is VERY poor (it is
  202.           not designed that way).  It would be better to encode 16-color
  203.           GIF files with VGAFIL then use another program (eg., VPIC) to
  204.           convert the 16-color GIF to a 16-color PCX file.
  205.          
  206.  
  207.  
  208.     THE CHAINED VGACAD ENVIRONMENT
  209.  
  210.     BRUN41.exe is a runtime module distributed under licence with Microsoft;
  211.     it can be distributed and used ONLY in connection with this program.
  212.     You can place it in any drive/directory as long as your PATH has access
  213.     to it.  VGACAD v2.0 and up integrates VGAFIL into its chained
  214.     environment; it is actually a module of VGACAD (v2.0 and up), when
  215.     released.
  216.  
  217.     The advantage of using the BRUN41.exe is an integrated system of
  218.     utilities and "sub-programs".  New releases will be modified to support
  219.     the "chained environment", with VGACAD as the integrator.  Only one copy
  220.     of BRUN41.exe is required.
  221.  
  222.  
  223.     USING SVGA SCREEN GRABS IN VGACAD (v1.6 and up)
  224.  
  225.     If you capture a 640x480x256 or 800x600x256 screen for direct editing in
  226.     VGACAD then:
  227.  
  228.     (1)  from the VSCRN Menu, create a blank 640x480 or 800x600 Virtual
  229.          Screen (whichever corresponds to captured screen);
  230.  
  231.     (2)  exit VGACAD and DO NOT DELETE the TEMP files;
  232.  
  233.     (3)  overwrite TEMP.RAW and TEMP.PLT with the selected SCREENxx.RAW
  234.          and SCREENxx.PLT files; for example, at DOS prompt type
  235.  
  236.                         "COPY screen00.* temp.*" <ret>
  237.  
  238.     (4)  run VGACAD and load TEMP.PLT at the Files Menu;
  239.  
  240.     (5)  click the VSCRN box; at the VSCRN Menu, click iSCR vDSK then OK;
  241.          you see the captured 640x480x256 or 800x600x256 image as the new
  242.          Virtual Screen.
  243.  
  244.  
  245.     REGISTRATION
  246.  
  247.     REGISTRATION OF VGACAP IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR
  248.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  249.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  250.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE
  251.     TO INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON
  252.     (NOT A JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE'
  253.     VGACAP OR VGAFIL.
  254.  
  255.     ┌───────────────────────────────────────────────────────────────────┐
  256.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  257.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  258.     └───────────────────────────────────────────────────────────────────┘
  259.  
  260.     As token of our appreciation (i.e., to registered users), we will send
  261.     you the the latest version of the VGACAD system; many of the programs
  262.     listed below do not require a graphics card.
  263.  
  264.  
  265.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop
  266.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's
  267.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.
  268.     Includes printing on IBM/Epson printers. Several sizes. 8 pics/page.
  269.     Single/Double Pass printing. Preview in CGA/HGC/EGA/VGA/EEGA/SVGA.
  270.     Histogram-equalization.  No graphics card required.
  271.  
  272.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !)
  273.     to grey shades for VGACAD image processing, GIFPUB redithering or
  274.     printing, or VGA2EGA conversion - it edits those "scan line jitters".
  275.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  276.  
  277.     SQZGIF/EGA2VGA - converts LARGE GIF/PCX pics (to 2KBx2KBx256) to
  278.     several sizes and video modes using "color averaging" to blend/smooth
  279.     "jaggies" or fast interpolation.  Variable sizing.  Also, converts
  280.     GIFs (16 colors and below) and creates up to 256 new colors; outputs
  281.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  282.     No graphics card required.
  283.  
  284.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an
  285.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  286.  
  287.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or
  288.     color and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  289.  
  290.     GIFHEX (formerly VGA2EGA) - converts 256-color pictures to 16-color
  291.     EGA or VGA .  Error-distributed dithering.  User support to 1024x768.
  292.     Variable sizing/RGBICMY/contrast.  EGA/MCGA/VGA required.
  293.  
  294.     MVGAVU - EGA/MCGA/EEGA/VGA/SVGA viewer for GIF and BLD/PLT files.
  295.     Smart slideshows - picks best mode.  320x400x256, 360x480x256 and
  296.     640x400x16 modes on regular VGA.  EGA posterization.  EEGA/SVGA
  297.     support.  Auto-sizing.  Contrast/Brightness.  EGA/MCGA/VGA required.
  298.  
  299.     VGACAD - extensive paint/image processing program for VGA/MCGA users
  300.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image
  301.     processing functions (smoothing, noise removal, shading, contrast
  302.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing,
  303.     256-color gradient/pattern fills, MORE !  Full screen SuperVGA editing
  304.     and image processing function to 1024x768x256.   360x480x256 support.
  305.     MCGA/VGA required.
  306.  
  307.  
  308.     WHAT'S NEXT ?
  309.  
  310.     Aside from enhancing existing releases with increased capabilities
  311.     (e.g., expanded memory, virtual screen, SVGA functions, other graphics
  312.     formats), we are developing VGACBT, a Computer-Based Training program
  313.     and MANNEQUIN for Advertising/Fashion Design or creating your own
  314.     artistic nudes.
  315.  
  316.     Support maverick authors like us and we will continue developing
  317.     products like nothing seen commercially - otherwise they will simply
  318.     "DIE" from lack of support !  Compare the cost/benefit ratio of any of
  319.     our products with commercial products.  You, and you alone, determine
  320.     whether it will be worthwhile to continue developing.  Support the
  321.     User-Supported (Shareware) concept.  Register you Shareware copies.
  322.     To register, send the registration form and check or money order
  323.     payable in USD to:
  324.  
  325.                              Dr. Marvin Gozum
  326.                  2 Independence Place #1105, 6th & Locust
  327.                           Philadelphia, PA 19106
  328.  
  329.  
  330.     ───────────────────────────────────────────────────────
  331.     Graphics Interchange Format and GIF are trademarks (tm)
  332.     of CompuServe Inc. an H&R Block Company.
  333.  
  334.